Inside Macintosh: QuickTime Components /

Chapter 2 - Movie Controller Components / Movie Controller Components Reference

Movie Controller Functions / Managing Controller Attributes

MCSetControllerAttached

The MCSetControllerAttached function allows your application to control whether a movie controller is attached to its movie or detached from it. "About Movie Controller Components," which begins on page 2-4, discusses the differences between attached and detached movie controllers.

pascal ComponentResult MCSetControllerAttached 
                                       (MovieController mc,
                                        Boolean attach);

mc

Specifies the movie controller for the operation. You obtain this identifier from the Component Manager's OpenComponent or OpenDefaultComponent function, or from the NewMovieController function (described on page 2-28).

attach

Specifies the action for this function. Set the attach parameter to true to cause the controller to be attached to its movie. Set this parameter to false to detach the controller from its movie.

DESCRIPTION

By default, a new movie controller is attached to its movie.

SPECIAL CONSIDERATIONS

Your application should not make any assumptions about the location of an attached movie controller with respect to its movie. The controller may be above, below, or surrounding the movie image.

SEE ALSO

If you need to know the location of the controller, you can use the MCGetControllerBoundsRect function, described on page 2-39, to obtain its boundary rectangle.